home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / facc10.zip / FACADE-C.TXT < prev    next >
Text File  |  1995-02-02  |  23KB  |  539 lines
  1.  
  2.  
  3.  
  4.     ╔════════════════════════════════════════════════════════════════════╗
  5.     ║                                                                    ║
  6.     ║                                                                    ║
  7.     ║                             Facade-C                               ║
  8.     ║                       --------------------                         ║
  9.     ║                       (Facade for Clipper)                         ║
  10.     ║                                                                    ║
  11.     ║                                                                    ║
  12.     ║      developers' pcx splashscreen display for DOS applications     ║                           ║
  13.     ║                                                                    ║
  14.     ║                                                                    ║
  15.     ║                     a product of RCCO Research                     ║
  16.     ║                                                                    ║
  17.     ║                                                                    ║
  18.     ╚════════════════════════════════════════════════════════════════════╝
  19.  
  20.  
  21.  
  22.  
  23.  
  24. Overview
  25. ---------
  26. FACADE-C (Facade for Clipper) is a special edition of the widely-used
  27. Facade(tm) developers' utility that addresses Clipper-specific issues.
  28.  
  29. Facade-C is basically a simple loader program that allows CA-Clipper(R) DOS
  30. applications to display a developer-designed VGA .pcx file as a sign-on image.
  31. Upon normal execution of the main application, Facade-C releases itself from
  32. memory, thus adding no overhead to the executable sequence.
  33.  
  34. The splashscreen displays for a developer-specified number of seconds, then
  35. calls the main executable just as it would have been executed from the system
  36. prompt.
  37.  
  38. Facade-C image displays will run under both DOS and Windows (full DOS screen).
  39. The utility is particularly effective for software developers preparing
  40. copyright or other splashscreens of their products.  The chief advantages,
  41. aside from the presentations themselves, are both low cost and method of
  42. acquiring.  The copy included herewith is a fully-functional evaluation
  43. copy available easily and universally through the user-supported software
  44. marketplace.
  45.  
  46. Please note there is a similarly-named version of Facade-C called Facade(tm)
  47. -- the standard version of the program for most MS-DOS language executables,
  48. including those created with Borland Turbo Pascal, QuickBASIC, PowerBasic,
  49. Visual Basic(tm) for DOS, FoxPro, dBase, Clarion, C, etc.  The standard
  50. version of Facade, also from RCCO Research, will also work well with
  51. CA-Clipper (although without the Clipper-specific features of Facade-C); we
  52. point out the similar names to help avoid confusion about the two products.
  53.  
  54. The Clipper-specific differences in Facade-C include elimination of any
  55. momentary screen delay from the time that standard Facade calls the overlaid
  56. program to the time that it takes for a large Clipper application to load.
  57. Facade-C, with provided Clipper coding, will allow the Clipper application
  58. to load during the time the pcx image is displayed on the screen.  Facade-C
  59. also provides for a default command-line setting of //E:0 //F:31, which
  60. appears desirable to a considerable number of Clipper programmers.  The
  61. length of time the image is displayed to the end-user may be specified by
  62. the developer (standard Facade is set at an invariable 4 seconds).  While
  63. adding some coding (usually about six lines) on the part of the Clipper
  64. developer, Facade-C differs from the standard version of Facade in that it
  65. is slightly less convenient to set up and use.
  66.  
  67. Facade-C is significantly different in internal operation from standard
  68. Facade and may offer an advantage for the serious Clipper developer.  The
  69. executable file sizes for Facade and Facade-C are very similar, however --
  70. a factor that should appeal in particular to the Clipper developer.
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77. Facade-C.exe and the sample files
  78. ----------------------------------
  79. To run the files included in this package (FACADE-C.EXE and 2 sample files:
  80. _ADMIN.PCX, _OVERL.PRG),
  81.  
  82.                    Compile and link,
  83.  
  84.                         clipper _overl
  85.                         rtlink fi _overl lib nanfor
  86.  
  87.                    then execute from the DOS prompt:
  88.  
  89.                         facade-c <enter>
  90.  
  91.  
  92. Please note that NANFOR.LIB is used in the sample program.  If you do not
  93. have or do not use nanfor.lib, examine and modify _overl.prg to use similar
  94. display functions available in various Clipper libraries (including CA-Clipper
  95. Tools).  Substitute the functions that determine display adaptor and set
  96. display mode from graphics back to text mode.  The sample program assumes use
  97. of CA-Clipper v5.x.
  98.  
  99. For tolerable viewing results, do not run the above Facade-C sample sequence
  100. from a floppy drive.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107. Preparation of images
  108. ----------------------
  109. Facade-C is particularly effective for software developers preparing
  110. copyright or other splashscreens of their products, in that they can easily
  111. capture usable materials with programs like Hijaak(tm) for Windows and
  112. modify or create them in editing programs such as Windows(tm) Paintbrush.
  113.  
  114. The only requirement is that images must be finally saved in 640x480 16-
  115. color VGA .pcx file format.  If you are doing image preparation in Windows,
  116. you will have to load a 16-color video driver for 640x480 VGA in order to
  117. prepare proper images.  This format is used since it is the most universal
  118. that will allow presentations to be viewed on as many DOS and/or Windows
  119. VGA systems as possible.  Do not build your images with 256 or more colors
  120. as they will not display with Facade-C.  The end-user should then be able
  121. to properly display using any VGA card and driver with 16 or more colors;
  122. it is only during the preparation and saving of .pcx images that you must
  123. use a 640x480x16 driver.
  124.  
  125. We have observed excellent, consistent results with using a program such as
  126. Hijaak(tm) for Windows to capture entire DOS or Windows screens, or selected
  127. areas of screens, or a particular window on a full Windows screen.  The
  128. preparer then does final editing, adding text, drawing lines or other objects,
  129. in a drawing program.  For example, the sample sign-on screen provided with
  130. this package was done entirely in the program that comes free with Windows:
  131. Paintbrush.  The inset picture was captured from a black and white line
  132. drawing with a hand scanner and edited in Paintbrush.
  133.  
  134. Other graphics programs are likely to provide compatible material, but they
  135. must be tried on a test basis with Facade-C.  The two programs mentioned
  136. above work well for most users, are widely available, and do not require
  137. great technical or professional ability.  Scanned images will be effective
  138. in Facade-C if they are saved in the proper format.  If one format you are
  139. using seems not workable, try saving that image in another program, such as
  140. Windows Paintbrush; we have often found that certain images work better when
  141. converted or simply saved in another program's format even though they may
  142. use the same .pcx extension.
  143.  
  144. When attempting to use monochrome pcx files, resave them as 16-color
  145. 640x480 VGA pcx files.  Even though the appearance may remain the same,
  146. they will be saved in a format usable by Facade-C.
  147.  
  148. Once you find the right combination of steps to produce pcx file formats
  149. consistently usable by Facade-C, you will save a great deal of time and
  150. effort by always using that combination in future applications.
  151.  
  152.  
  153.  
  154.  
  155.  
  156. Required naming convention for the .pcx file
  157. ---------------------------------------------
  158. After you have prepared the desired .pcx file, simply rename it
  159.  
  160.                                  _ADMIN.PCX
  161.  
  162. The basic requirement is that the image file and the related executables be
  163. placed in the same directory on a hard drive.  Alternatively, the executables
  164. may be in the path, but the file _admin.pcx must be local in every directory
  165. from which you wish the image to display.  You should advise end-users against
  166. running your application from a floppy diskette, due to the slowness of
  167. building the on-screen image when reading from a diskette.
  168.  
  169. Your end-users will certainly need VGA graphics capabilities to view your
  170. splashscreen.  If a user attempts execution on a non-VGA-capable system, a
  171. simple screen will very briefly display the message
  172.  
  173.  
  174.  
  175.  
  176.                    ╔════════════════════════════════════════╗
  177.                    ║                                        ║
  178.                    ║          Loading application...        ║
  179.                    ║                                        ║
  180.                    ╚════════════════════════════════════════╝
  181.  
  182.  
  183.  
  184.               This software program contains copyrighted material.
  185.               All Rights Reserved under International Conventions.
  186.  
  187.  
  188.  
  189.  
  190.  
  191. and continue without much delay.  (The wording on this screen may be changed
  192. by the developer with a hex editor, if desired.)
  193.  
  194.  
  195.  
  196.  
  197.  
  198. Preparation of the main Clipper executable
  199. -------------------------------------------
  200. Head your main program file similarly to the provided _overl.prg sample; that
  201. is, at the beginning of your main .prg file:
  202.  
  203.  
  204. /* initialize variables, open tables, do other non-screen stuff here.
  205.    Judicious use of dispbegin() and dispend() will also provide ability to
  206.    build complex opening screens without disturbing the suspended VGA pcx
  207.    image. */
  208.  
  209.  
  210. // for vga pcx hold-on:
  211. if ft_adapter() == 3     //  if vga, Facade-C has initiated graphics mode, so
  212.    inkey(4)              //      hold image in view for 4 seconds, then
  213.    ft_setmode(3)         //      return to text mode display.
  214. else                     //  if not vga, Facade-C displays brief "Loading...".
  215.    cls                   //  ugly stuff if you don't clear text screen here.
  216. endif
  217.  
  218.  
  219. /* do what you will from this point on */
  220. ...
  221.  
  222.  
  223. The ft_* functions are in nanfor.lib; if using another library, substitute
  224. the functions that determine display adaptor and set display mode back to
  225. text.
  226.  
  227. You may of course vary the number of seconds or fractions thereof that the
  228. image is held in view with inkey().  There are also superior sleep()-type
  229. functions for marking time that would not allow for keypress interruption as
  230. does inkey().
  231.  
  232. Facade-C requires use of the above code or its equivalent in a Clipper .prg
  233. file; the standard version of Facade does not have the same requirement.
  234.  
  235. The developer's Clipper application to be launched must be named (via the
  236. .lnk file; see below):
  237.  
  238.                         _OVERL.EXE
  239.  
  240.  
  241. The file FACADE-C.EXE would be then renamed to 'MYAPP.EXE' or whatever the
  242. developer's application was originally called, so that the end-user executes
  243. the original program name.
  244.  
  245. The calling sequence then becomes:
  246.  
  247.                         MYAPP.EXE <enter>
  248.  
  249.        displays         _ADMIN.PCX  (if VGA system is found)
  250.  
  251.        then executes    _OVERL.EXE
  252.  
  253.  
  254. at which point the developer's original application (now called _OVERL.EXE)
  255. will take over and execute normally.
  256.  
  257. PLEASE NOTE:  Clipper 5.x developers using .RTLink or BLINKER should not
  258. rename their executable files to _OVERL.EXE with the DOS REN command (see
  259. the section on Troubleshooting, below).  They should relink the executable
  260. as follows:  specify in the .lnk file that the output name is to be
  261. _OVERL.EXE (i.e., OUTPUT _OVERL).
  262.  
  263. You need not issue a clear screen (cls) command at the beginning of your
  264. application (except as indicated in the provided code sample for non-VGA
  265. instances).  Facade-C clears the screen automatically upon terminating the
  266. VGA image display.
  267.  
  268.  
  269.  
  270. Clipper command-line settings
  271. ------------------------------
  272. Facade-C.exe provides for passing a default command-line setting of
  273. //E:0 //F:31 to your application.  You may change the //F: parameter to
  274. another number with a hex editor, if desired; search for the text F:31 which
  275. occurs in two places.
  276.  
  277.  
  278.  
  279.  
  280.  
  281. Troubleshooting
  282. ----------------
  283. One caveat we might offer with this program is that if you find that your
  284. images do not display, or do not display properly, it is probably because
  285. they have been created or saved in a format that may only be slightly
  286. incompatible with that which Facade-C requires.  Before you decide that the
  287. Facade-C program is not usable in such instances, try the suggestion given
  288. before for re-saving your .pcx files in another graphics program.  Most
  289. image-editing programs will read files in several formats, and often allow
  290. conversions, or perhaps will save them in a later .pcx format that will work
  291. with applications such as Facade-C.
  292.  
  293. Also, make certain that images are saved in 640x480 by 16-color format by
  294. using the proper software and/or video drivers to handle the format.
  295.  
  296. CA-Clipper 5.x developers using .RTLink or BLINKER who experience runtime
  297. unrecoverable error messages 415 (cannot open overlay file) or 416 (read
  298. error on overlay file) when renaming their executable files to _OVERL.EXE
  299. with the DOS REN command should simply relink the executable as follows:
  300. specify in the .lnk file that the output name is to be _OVERL.EXE (i.e.,
  301. OUTPUT _OVERL).
  302.  
  303. Developers using BLINKER's SwpRunCmd() function should well-test any
  304. application that is loaded with Facade-C.  If you experience a swap error
  305. when attempting to return from a SwpRunCmd() call, you should consider
  306. whether or not that Blinker function is absolutely essential to the
  307. application.  We know of no workaround at this time other than using the
  308. Clipper RUN command.
  309.  
  310. Please let us know if you have continued or other difficulties in making
  311. Facade-C work as described with CA-Clipper, as well as any solutions or
  312. workarounds you may have found.
  313.  
  314.  
  315.  
  316.  
  317. Program Requirements
  318. ---------------------
  319. The requirements for running Facade-C include a DOS-compatible PC with 512k
  320. memory, VGA graphics capability, and a hard drive.  DOS 3.1 (or later) or
  321. Windows 3.x (or later) should be utilized.  CA-Clipper 5.x or later should
  322. be used with Facade-C.
  323.  
  324.  
  325.  
  326.  
  327. The Unregistered Evaluation Copy
  328. ---------------------------------
  329. The unregistered version of this program is intended for use in evaluation
  330. situations.  It may be used for ninety (90) days within your own organ-
  331. ization by persons that have knowledge and understanding of the fact that
  332. this is an unregistered evaluation copy.
  333.  
  334. The payment of the $40.00 purchase price for a registered copy of this
  335. program will allow license for a single user to make use of the program for
  336. purposes that are traditionally accepted for software utilities of this
  337. type.  Additional site license fees of $15.00 per user may be paid at the
  338. time of registration, or any time in the future after initial registration
  339. at the then current license fee in effect.  There are no runtime royalties
  340. involved in the distribution of your materials utilizing a duly registered
  341. copy of Facade-C.
  342.  
  343. The license and authorized registration shall not be construed as being
  344. in effect until direct payment has been received by RCCO Research and an
  345. authorized, registered copy has been sent in the registered user's/users'
  346. name(s).
  347.  
  348.  
  349.  
  350.  
  351.  
  352. The Registered Version of Facade-C
  353. -----------------------------------
  354. The registered copy performs the same execution as the evaluation copy, only
  355. without the unregistered copy delay at the beginning of the VGA display.
  356.  
  357. Documentation for the registered version is an on-disk text file, similar to
  358. the present format.
  359.  
  360. Facade-C has a different pricing structure for registration and fees than
  361. does the standard version of Facade.
  362.  
  363.  
  364.  
  365.  
  366.  
  367. Licensing Information
  368. ----------------------
  369. This program is licensed and supplied as is, without any warranty.  To the 
  370. extent permitted under applicable law, RCCO Research Associates disclaims 
  371. all warranties, either expressed or implied, with respect to this software 
  372. program, its quality, performance, merchantability, or fitness for any 
  373. particular purpose.
  374.  
  375. In particular, this software program is not guaranteed to prevent or detect
  376. damage to your data or programs.  In no event shall RCCO Research Associates
  377. be liable for any claims for lost profits or any damage, including, but not
  378. limited to, special, incidental, consequential or other damage (including, 
  379. without limitation, damages for loss of business profits, business interrup-
  380. tion, loss of business information, or other pecuniary loss) arising out of
  381. the use of or inability to use this RCCO Research Associates product, even
  382. if RCCO Research Associates has been advised of the possibility of such
  383. damages.  Some states do not allow the exclusion or limitation of incidental
  384. or consequential damages, so the above limitation or exclusion may not apply
  385. to you.  In no case shall RCCO Research Associates's liability exceed the
  386. license fees paid for the right to use the licensed version of the software. 
  387.  
  388. The license agreement and warranty shall be construed, interpreted and
  389. governed by the laws of the state of Tennessee.
  390.  
  391. This software program is protected under the Copyright Laws of the United 
  392. States of America and all applicable International Copyright Conventions.  
  393. Makers and/or users of illegal or unauthorized copies of the registered 
  394. version are subject to prosecution under these laws.
  395.  
  396. The name Facade(tm) is a trademark of RCCO Research Associates.  Windows(tm)
  397. is a trademark of Microsoft Corporation.  Other trade names referenced herein
  398. are either trademarks or registered trademarks of their respective companies.
  399.  
  400.  
  401.  
  402.  
  403.  
  404. Registration Notes
  405. -------------------
  406. Registration will obtain a copy of the most recent authorized version and
  407. provide legal authorization for continued use of the program after the
  408. ninety-day (90-day) evaluation period.
  409.  
  410. To obtain a registered copy, you may mail an advance-payment registration
  411. fee of U.S. $40.00 + $2.50 shipping/handling ($7.00 non-U.S. shipping/
  412. handling, $4.00 for Canada) directly to RCCO Research.  Additional users
  413. are $15.00 per user.  Payment is to be made by check or money order only,
  414. please.  We require payment with order so that prices and fees may be kept
  415. as reasonable as possible; this policy has worked well for us in recent
  416. years, as we observe increased registration on products that are reasonably
  417. priced.  For credit card and telephone orders, see the Additional Ordering
  418. Options note below.
  419.  
  420. Currently registered users of the standard version of Facade may purchase
  421. Facade-C at a special price; please contact RCCO Research directly for
  422. specifics.
  423.  
  424. An invoice will be included with your order, showing the registered serial
  425. number(s) applicable to the purchase.  We can provide a pro forma invoice
  426. to those corporations or institutions that require same before payment can
  427. be issued; shipment will be made promptly upon receipt of payment.  Prices
  428. and/or registration and/or license fees are subject to change.
  429.  
  430. Tennessee clients please include the required 8.5% sales tax on both the
  431. product amount and shipping/handling as mandated by the state.
  432.  
  433. International clients must pay by check or money order in U.S. dollars, drawn
  434. on a U.S. bank or the U.S. branch of an international bank.  Please realize
  435. that international postal money orders are considerably delayed through the
  436. postal systems and may not be the most expedient way of relaying payment.  An
  437. often-used form of payment consists of obtaining a dollar-denominated money
  438. order from the local American Express office which you may then airmail to
  439. us along with your order.  International orders are dispatched promptly when
  440. using a credit card order as outlined below.
  441.  
  442. Please indicate program name and current version number on your order; you
  443. may use the Order.frm file provided on the disk (or the program directory)
  444. or simply send a note or letter with your name, organization name, address,
  445. program name & version, number of users being licensed, and remittance.
  446. Your comments on our programs are welcomed.
  447.  
  448.  
  449.  
  450.  
  451.      Additional Ordering Options:
  452.      ----------------------------------------------------------------------
  453.      CREDIT CARD ORDERS ONLY -
  454.      You may order a registered copy of this RCCO Research program
  455.      with MasterCard, Visa, Amex, or Discover from PsL, Public (software)
  456.      Library of Houston, Texas by calling 800-242-4775 or 713-524-6394,
  457.      or by FAX to 713-524-6398, or by CompuServe E-mail to 71355,470.
  458.      You may also mail credit card orders to PsL at P.O. Box 35705,
  459.      Houston, TX 77235-5705.  PsL's item/product number for Facade-C
  460.      is #11698.
  461.  
  462.      THE ABOVE NUMBERS ARE FOR ORDERS ONLY.
  463.      Any questions about the status of the shipment of the order,
  464.      registration options, product details, technical support, volume
  465.      discounts, dealer pricing, site licenses, etc. must be directed in
  466.      writing to RCCO Research, P.O. Box 196, Gatlinburg, TN 37738.  To
  467.      ensure that you get the fastest possible delivery of your registered
  468.      copy, PsL will notify us the day of your order and we will promptly
  469.      ship the materials directly to you.  There are no additional fees
  470.      for ordering by credit card.
  471.  
  472.      Your credit card number is *not* transmitted to RCCO Research, but
  473.      rather is processed by PsL as part of their software registration
  474.      service.
  475.  
  476.      The above service is made available as a convenience to client
  477.      individuals who feel comfortable with ordering by telephone and
  478.      with a credit card.  Established concerns may prefer to order
  479.      directly from RCCO Research with the company's own business check.
  480.  
  481.      The PsL staff cannot answer non-order inquiries.
  482.      ----------------------------------------------------------------------
  483.  
  484.  
  485.  
  486.  
  487.  
  488. Additional Information
  489. -----------------------
  490.  
  491. Facade-C is written in C using Microsoft C 6.0.
  492.  
  493.  
  494. If you have any comments or questions regarding this program after (or with)
  495. registration, please send them to:
  496.  
  497.                               RCCO Research Associates
  498.                               P. O. Box 196
  499.                               Gatlinburg, TN 37738-0196
  500.                               (U.S.A.)
  501.  
  502. Please include your phone (day & evening) and fax (if any) numbers as well
  503. as your mailing address (and CompuServe number / Internet address, if any) on
  504. ALL written communications.  Please indicate the serial number from your copy
  505. of the program as well as your CustID number.  Our E-mail addresses are
  506. provided to registered users along with the invoice.
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513. Facade-C
  514. ---------
  515. (Facade for Clipper)
  516.  
  517. developers' pcx splashscreen display for DOS applications
  518.  
  519.  
  520.  
  521. (C) Copyright 1994-95 RCCO Research Associates
  522. All Rights Reserved under International Conventions
  523. Product of U.S.A.
  524.  
  525.  
  526.  
  527. RCCO Research Associates
  528. Post Office Box 196
  529. Gatlinburg, Tennessee 37738 (U.S.A.)
  530.  
  531.  
  532.                                     
  533.                      ┌─────────────────────────────────┐
  534.                      │     RCCO Research Associates    │
  535.                      │ Technical Publishers, Est. 1965 │
  536.                      └─────────────────────────────────┘
  537.  
  538.  
  539.